home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / utilmnu1.zip / UTILMENU.DOC < prev    next >
Text File  |  1994-03-02  |  8KB  |  194 lines

  1.  
  2.                                 UTILMENU!
  3.  
  4.                                   v1.1
  5.  
  6.                                    by
  7.  
  8.                               Bart Flentje 
  9.  
  10.                             
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 OVERVIEW
  17.                                 ________
  18.  
  19.   Simple.  This program allows you to expand your DOS hooks or your doors
  20.   menu system.
  21.   
  22.   This program was written for my purposes only and upon several requests
  23.   fo a CHEAP DOS hook expansion system, I have released it as SHAREWARE.
  24.   Any revisions will be made available to the public as a always with my 
  25.   programs.  If anyone decides to register this product, as in ALL of my 
  26.   programs, ALL future upgrades are absolutely free.
  27.  
  28.   This program WAS written using a registered version of Door Frame for 
  29.   which I give full credit to Ted Freeman.  God Bless.
  30.  
  31.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  32.          created in the directory you run the door from.
  33.  
  34.  
  35.  
  36.                               INSTALLATION
  37.                               ____________
  38.  
  39.  
  40.    BEFORE WE START....  This program requires a key to run...!  This key
  41.    must be placed in the .CFG files before operation.  A key has been put
  42.    into the .cfg file, but it may not be current at the time of your d/l.
  43.    If the key is not valid, you can either get another temporary date key
  44.    or you can register.  You can do both by calling Bit Debris BBS at
  45.    612-686-8106.  Temporary date keys are good for each month and must be
  46.    a SEVEN digit number.  You cannot run UTILMENU by placing 7 0's in the
  47.    place of the key.
  48.  
  49.    Installation is fairly easy and straight-forward. The following steps and
  50.    examples should have you up and running in a very short period of time.
  51.    It is assumed that you are familiar with setting up DOORS on your system.
  52.    
  53.    **********************
  54.    
  55.    **********************
  56.    
  57.    To this end, only examples of the configuration file and Door batch file
  58.    are described.
  59.  
  60.       1) Create a directory to hold all UTILMENU files
  61.  
  62.       2) Unzip UTILMENU.ZIP into the the above directory
  63.  
  64.       3) Create a configuration file, with a name of your choice, or
  65.          modify the supplied UTILMENU.CFG file. A description follows:
  66.  
  67.      1      C:\WC30\WCWORK\NODE1\USERINFO.DAT     Path to system file
  68.      2      Eagan Wildcat! BBS                    Your BBS Name
  69.      3      Bart                                  Sysop's First name
  70.      4      Flentje                               Sysop's Last Name
  71.      5      0000000                               Registration Number
  72.      6      batch#1.bat                           The batch files of the
  73.      7      batch#2.bat                           door programs you want to
  74.      8      and so ....                           run.  They must exist in
  75.                                                   same directory as UTILMENU.
  76.  
  77.                NOTE: There are NO Blank Lines in the Config File!!
  78.                      AND do NOT enter more than 30 batch files.  It
  79.                      should not hurt anything, but don't do it anyways.
  80.  
  81.       
  82.       4) Create a batch file or modify the UTILMENU file supplied. A
  83.          description of this file follows:
  84.  
  85.             This could be MAIN1.BAT, MAIN2.BAT, DOOR1.BAT, etc.
  86.  
  87.                 cd\wc30\door5
  88.                 :Restart
  89.                 if exist doit.bat del doit.bat
  90.                 utilmenu utilmenu.cfg
  91.                 if exist doit.bat call doit.bat
  92.                 if errorlevel 1 goto End
  93.                 if exist doit.bat goto Restart
  94.                 :End
  95.  
  96.                 The batch file must have the EXACT same structure as this
  97.                 example.  Obviously you'll have to modify the paths to suit
  98.                 your needs.
  99.  
  100.     \   
  101. -----> 5) You will need to edit the UTILMENU.ANS menu screen to suit your   
  102.     /     needs.  It may look like anything you want AS LONG as the top line
  103.           is left blank and the screen does NOT EXCEED past the 20th line.
  104.           I also strongly suggest you make sure that any extra line feeds are
  105.           removed from the file!!!!!!!  ** important***   
  106.           TheDraw seems to be the best ANSI editor on the market which would
  107.           sufficient to edit the menu screen.
  108.  
  109.        
  110.        6) When running in more than one node, make sure you set up your
  111.           .CFG file to reflect this.  Instead of creating many different
  112.           .CFG files, the environment variable is supported INSIDE of these
  113.           .CFG files.  My example shows how it should look.  
  114.  
  115.           Single line users must change the %NODEID% environment variable to
  116.           a "1" so it looks like .....WCWORK\NODE1\... 
  117.  
  118.   
  119.  
  120.  
  121.                              COM Support
  122.                              ___________
  123.  
  124.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  125.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  126.       number after the configuration filename. Let's assume your Door is
  127.       called BATMAN and you want to use COM1 and IRQ5. The command line
  128.       passed to your Door would be:
  129.                                    BATMAN BATMAN.CFG /5
  130.       The /5 tells BATMAN to use IRQ5 rather than the standard IRQ4 that is
  131.       normally used with COM1. No /x parameter is needed for the standard
  132.       IRQ's.
  133.  
  134.  
  135.                               
  136.                               LEGALITIES
  137.                               __________
  138.  
  139.  
  140.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  141.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  142.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  143.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  144.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  145.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  146.       OR BREACH OF ANY WARRANTY.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                              DISTRIBUTION
  153.                              ____________
  154.  
  155.    You may make this file available for downloading from your BBS or you may
  156.    upload it to any BBS of your choice, provided that you do not make any
  157.    changes to the contents of the archive (ZIP file). The archive and its
  158.    individual contents may not be used by any service that charges any money
  159.    whatsoever, without the written permission of the author.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.                              REGISTRATION
  166.                              ____________
  167.  
  168.    Registration and the subsequent insertion of the registration number into
  169.    your configuation file, allows for the display of your BBS name on the
  170.    opening and closing screen as well as the reduction of a delay built into
  171.    the opening screen display along with the ability to change certain
  172.    values in the configuration file.
  173.  
  174.    To register your copy of UTILMENU, please fill out the registration form
  175.    (REGISTER.DOC) and mail it along with $10.00 to the authors address.  
  176.    Registration keys will work for all future upgrades of this program and
  177.    you will not be let down. (all registrations are NON-refundable!)
  178.    
  179.    Be sure to fill in your name and BBS name as you wish to have them shown
  180.    and they MUST match the way you entered them in the configuration file.             
  181.  
  182.    Remember, if you should have any problems with your door game, feel free
  183.    to get in touch with me on the MSI HQS BBS (1-805-395-0250) or you may
  184.    call me voice at 612-686-6276. (Before 11:30 p.m. C.S.T.)
  185.    BBS number is 612-686-8106.
  186.  
  187.    We now accept credit cards for online registration.  Call the BBS and 
  188.    place your order today.
  189.  
  190.          Also available:    CalCat! v5.2  Holiday screen swapper.  Awesome
  191.                             ManDown! v1.6 force users to d/l files.
  192.  
  193.    
  194.